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ABSTRACT 



This is a highly graphic user-oriented interactive 
software product which will assist the user to become more 
proficient at recognizing and employing Navy signal flags 
and pennants which are used for visual communications 
between naval vessels of all types. A tutorial portion of 
the program has been designed with a number of options, 
thereby allowing a user to tailor a recognition program to 
satisfy specific learning requirements. The program is also 
capable of graphically displaying any grouping of flags and 
pennants chosen by the user in flaghoist order. When the 
flags and pennants are arranged in accordance with the pro- 
cedural doctrine set forth in the ALLIED MARITIME TACTICAL 
SIGNAL BOOK, ATP 1(B), Volume II, the program demonstrates 
the capability of decoding the displayed signal into its 
predetermined meaning. The current program is resident in 
the Secure Command, Control and Communications Exercise La- 
boratory (C3 Lab) at the Navy Postgraduate School. 
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I. INTRODUCTION 



A. BACKGROUND 

Most visual communications systems presently in use on 
board United States Navy ships have been employed in much 
the same manner for centuries. Their continued use is evi- 
dence of their utility and significance. Of the visual sys- 
tems incorporated today, "flaghoist" is the one most fre- 
quently used, even though its use is limited to the hours of 
daylight. Flaghoist is commonly used for clcse-in communi- 
cations in the fleet. 

Flaghoist involves the use of coded flags and pennants. 
Usually these flags and pennants are displayed prominently 
on a hoist running up to a yardarm on the ship's mast. Each 
"flag" (to include pennants) represents a letter, a numeral, 
or a designated special meaning. One flag or a grouping of 
flags in a prescribed order constitute a signal. In gen- 
eral, a flaghoist signal ensures a more uniform execution of 
a maneuver than any other system of visual communications. 

Flaghoist signaling provides a rapid and accurate system 
cf passing tactical and administrative information. 
Flaghoist is rapid because, by hoisting and displaying one 
or more flags that have a predetermined meaning, a ship can 
communicate simultaneously with all ships in company. It is 
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an accurate system for the reason that the receivers of the 
signal are required, to repeat the signal, flag for flag, al- 
lowing the originator to immediately confirm that those sent 
the signal received it correctly. In addition, flaghoist 
signaling aptly meets many security previsions, which can be 
considered a prime requisite for naval communications. Not 
only is the range limited, the meaning of the signal itself 
can only be found in a classified signal publication. Fi- 
nally, flaghoist signaling may be the only means of expedi- 
tious tactical communications during emergency conditions 
when any sort of electronic emissions from a ship may be 
prohibited for the very safety of that ship. 

In flaghoist signaling, the U. S. Navy uses 68 flags. 
These include the international alphabet flags (26), numeral 
pennants (10), and a Code/Answer pennant; a set of numeral 
flags (12), special flags and pennants (17); and four sub- 
stitutes, or repeaters. Each alphabet flag" has the phonetic 
name of the letter it represents. A numeral FLAG takes the 
name of the numeral it represents? numeral PENNANTS are only 
used in call signs. Special flags and pennants are used in 
tactical maneuvers tc direct changes to speed, position, 
course, and formation, to indicate and identify units, and 
for specialized purposes. In addition to the flags used for 
signaling, there is the tackline or "tack". The tackline is 
used to separate flags or groups of flags which, if not 
separated, could convey another meaning from that intended. 
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In most cases the tack is included in the signal to avoid 
any ambiguity. 

A flaghoist signal (message) consists of two parts: 
heading and text. The heading may be specified by hoisting a 
visual call sign? numerals in the ‘’call” of the heading are 
numeral pennants. More frequently, the heading is implied, 
and all that is hoisted is the text portion of the signal. 
The text usually is made up of flag combinations extracted 
from the ALLIED MAEITIME TACTICAL SIGNAL BOOK, ATP 1(B), 
Volume II. A signal is "read" by noting the flag positions 
starting from the top most outboard flag down the halyard to 
the bottom flag, then to the next most outboard top flag 
down to the bottom, etc., etc. A "display" is a complete 
signal, whether on one halyard cr on two or mere. 

ATP 1(B), Vol. II is the origin of most tactical commun- 
ications between allied naval units. The signal vocabulary 
of this publication is collected into chapters and arranged 
under headings for ease of reference. Chapter 1 contains 
general instructions for use of the book. Chapter 2 contains 
single flag and pennant signals. Chapter 3 contains emergen- 
cy alarm and emergency action signals. Chapters 4 through 9 
contain maneuvering signals which utilize a special pennant. 
Chapters 10 througn 31 contain the main signal vocabulary, 
which consists of operational and administrative signals ar- 
ranged in alphabetical order under appropriate headings. 
Chapter 32 consists cf supplementary tables which are used 
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tc augment and modify the meaning of certain basic groups. 
The signal vocabulary chapters are followed by an extensive 
signal index provided to assist the user in finding the 
desired groups when encoding signals. The overall security 
classification of ATP 1(B), Vol. II is NATO-CONFIDENTIAL, 
which requires a NATO special clearance (for confidential 
material) in order to be able to view its contents. 

Due to the classification of the ALLIED MARITIME TACTI- 
CAL SIGNAL BOOK and the sheer number of possible combina- 
tions of messages that can be formulated, all enlisted per- 
sonnel and officers responsible for decoding flaghoist sig- 
nals are actively discouraged from trying to memorize any 
signal contained in the publication. Even if an individual 
"thinks he knows" the meaning of a group of flags, there is 
a standing requirement to look the signal up in the publica- 
tion before reporting the meaning to a senior. 

The enlisted rating which is responsible for visual com- 
munications on board a ship is that of Signalman. Besides 
other duty responsibilities Signalman personnel are required 
to acquire and maintain a solid background and knowledge in 
procedures, methods, and rules pertaining to flaghoist com- 
munications. Fundamental to this tasking is a proficiency in 
readily identifying all signal flags and pennants used. 
Signalman "a" School presently devotes five hours of in- 
structional time to the learning of the signal flags. 
Within the officer ranks, every prospective Surface Warfare 
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Naval Officer receives a minimum of four hours of formal 
classroom instruction and practice in signal flag recogni- 
tion. Besides the time set aside in the classroom to learn 
the identity of all the flags and pennants mcst individuals 
(enlisted and officers) who have to learn them require an 
additional minimum of seven to ten hours to become 
"moderately proficient" with a "fair" amount of retention 
capability. 

The primary aid currently used by an individual in 
learning and studying the flags outside the classroom is the 
"Navy and International Code Flag Cards", device number 
5LL2> this is a product of the U.S. Naval Training Device 
Center produced by Erown and Bigelow ( FSN : 2C-6910-514-2Z33 ) . 
The "flash-cards" device consists of 75 playing-card-s i zed 
cards with a color picture of a flag or pennant on one side, 
and the name of the flag or pennant on the other. 

B. OBJECTIVE 



The main objective of this study was to produce a sim- 
ple, user oriented, yet all inclusive and foolproof computer 
program routine which would be able to "teach" a user the 
signal flags and pennants, and in addition, have the capa- 
bility to "decode" such flags and pennants displayed in 
groups in accordance with standard procedures delineated in 
ATP 1(B) , Vo 1 . II . 
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In striving tc realize the above stated objective other 
less significant objectives were achieved in the process. 
Among these objectives were: 

(1) To incorporate the C3 Laboratory — its assets and in- 
herent capabilities — as an integral and major part of 
the thesis itself; 

(2) To actively apply various programming techniques and 
design principles expounded in various academic 
courses to a specific real-world and Service related 
topic of interest; and, 

(3) To create a product which has the potential to be a 
meaningful contribution to the U.S. Navy. 
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II. PROGRAMMING OBJECTIVES AND DESIGN PRINCIPLES 



The graphic tutorial and decoding program for Navy sig- 
nal flags and pennants which satisfies the above objective 
was designed to be used on a PDP 11/70 computer located in 
the Secure Command, Control and Communications Exercise La- 
boratory (C3 Lab), at the Navy Postgraduate School. The C3 
Lab was developed for use as a research, test and evalua- 
tion, and experimentation facility. Designated a Remote 
Site Module (RSM), the C3 Lab is part of a secure computer 
network which also includes the Naval Ocean Systems Center 
(NOSC), in San Diego, California, Commander-in-Chief, U.S. 
Pacific Fleet, in Pearl Harbor, Hawaii, and the Fleet Numer- 
ical Oceanographic Center, located in Monterey, California. 
This secure network is referred to as the Advanced Command 
and Control Architectural Testbed (ACCAT) , and is certified 
to be able to handle and store classified material up to and 
including SECRET. A UNIX operating system is resident in 
the C3 Lab's PDP 11/70, and provides an on-line (time- 
sharing) computing system capability. In addition to Ann Ar- 
bor CRT terminals for entry/retrieval (I/O), the system sup- 
ports color graphics on Genisco display terminals. 

By understanding and taking advantage of the close in- 
teractive relationship between user and computer which is 
engendered by an on-line system, an effective user-oriented 
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program can be realized. To assemble ana collocate such a 
user-oriented program was the primary programming objective. 
To this end, the final criteria used to determine whether 
code was tc be incorporated or rejected in the tutorial and 
decoding program was if the inclusion of some particular 
code contributed in making the program more user-oriented. 

In the design cf a program where there is a high degree 
of interaction anticipated, perhaps the most important con- 
sideration is the "appearance” of the program to the user 
("the man-machine interface"). A program must be appealing 
for a user to want to use it more than once. And if the 
program is to be utilized by a variety of individuals having 
varied levels of expertise or experience, it has to be 
designed and formated in such a manner so that ANY user can 
understand what is expected at each point. Consequently, 
the more "advanced" user may have to accept and be tolerant 
cf this possible inconvenience although there are design op- 
tions that could be incorporated which have the potential to 
alleviate this problem to a great degree. Such "human en- 
gineering" considerations within a program can be some of 
the most time consuming and troublesome to resolve in creat- 
ing a program. 

There are a number of generally accepted "design princi- 
ples” that should be considered when creating a user orient- 
ed interactive program. All the following design principles 
were utilized in the tutorial and decoding program. 
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(l) Self-explanatory. 



(2) Self-helping. 

(3) Simple interface with user. 

(4) Interaction by anticipation. 

(5) Optional verbosity. 

(6) Echoing 

Although more "transparent” to a user than those above, 
the following are also considered as necessary elements for 
a truly successful user oriented interactive program. 

(7) The exiting from a program should be a "reversible 
reques t " . 

(8) The program should be able to accept direct comment 
from the user. 

(9) The user should never be embarrassed, belittled or 
chastised. 

Each one of the above listed design principles is 
described more fully in the following remaining paragraphs. 

A "self-explanatory" program is one which presents the 
user sufficient tutorial information about the program it- 
self to enable the user to proceed without reference to some 
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external source of explanation (a separate user's manual for 
example). This is accomplished by presenting certain neces- 
sary and basic items and allowing the user to opt for addi- 
tional supplementary or tutorial material if desired. 

A "self-helping" program provides checking of user in- 
puts to the program and provides reminders or advisories 
when the user requests help. This is accomplished by check- 
ing the input for validity or reasonableness, and if ap- 
propriate, sending a diagnostic message. This message might 
inform the user that the last entered input is incorrect ei- 
ther in format (usually a typing error), or content. When a 
user specifically requests assistance, the program should be 
structured to respond in some manner providing the user with 
enough helpful information to resolve, hopefully to the 
user's satisfaction, the apparent predicament the user is 
experiencing. 

"Simple interface with user" is accomplished by ensuring 
that the actions and inputs required by the user are short, 
simple, and obvious. One aspect of the interface is the 
grouping of options presented within the program. For exam- 
ple, if many options are available, it is probably easier 
for an on-line user to make his choice if the options can be 
presented in subgroups of six or fewer items. More than this 
amount can become "mind boggling" and is, therefore, coun- 
terproductive. 
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"interaction by anticipation" is achieved by anticipat- 
ing all possible desires a user may have and presenting the 
user with choices which include all of those possibilities.. 
This method enables the user to SELECT (by letter/number/or 
short phrase) rather than SPECIFY (type out in entirely) a 
desired option. 

"Optional verbosity" allows for two (or more) levels of 
detail to occur in the interface with the user. For the no- 
vice or first-time user, the interface should contain de- 
tailed explanations in order to insure that the user com- 
pletely understands what is expected, and what the program 
is capable of performing. On the other hand, an experienced 
user familiar with the program or subject matter might want 
to choose a mode of operation with few or no explanations 
and abbreviated communications (terse messages) . A verbosity 
option can resolve the problem between presenting too much 
or too little. 

"Echoing" (which could be a verbosity option itself) al- 
lows the user instant feedback in order to verify that the 
input entered (which may even be used or enacted upon at a 
later time) has been accepted and that it indeed was the 
correct option/input desired in the first place. 

A "reversible request" provides the user "one last 
chance" to consider the consequences of the most recently 
entered action without any dire consequences occurring. In 
the exiting of a program, the user is asked if termination 
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is actually desired. If termination is indeed desired 
(reconfirmed), the user is thanked, and then allowed exit 
(gracefully) from the program. If, on the other hand, the 
user wishes to return to the program and continue, the pro- 
gram returns the user to the point in the program previously 
located . 

A program is only useful if it can satisfy a user's 
needs and requirements. Since many of these desires are not 
fully known until the user is actually using it, a built-in 
feature to accept "keyed in" comments, criticism, or sugges- 
tions can be extremely worthwhile. Net only will it permit 
the user to vent possible anger, the comments, where feasi- 
ble, can be invaluable in developing improvements to the ex- 
isting program thereby enhancing the overall man-machine in- 
terface appearance of the program itself. 

Finally, a program is a tool. If it somehow conveys an 
attitude of "superiority" to the user, the user may be in- 
clined not to employ it. Therefore, a conscientious and 
deliberate effort must be made on the part of the creator of 
a program to treat the user with respect and courtesy. No 
other approach toward the user can be as effective. 
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III. PROGRAM DESCRIPTION 



The graphic tutorial and decoding program for Navy sig- 
nal flags and pennants that was created consists of 12 
separately compiled programs which have been structured to 
interact with one another. Certain values are carried 
between various programs to maintain continuity among all of 
the programs. Memory space limitations during the compila- 
tion of a program, and the conscientious effort, in keeping 
with good programming practices, to "modularize" the program 
into a number of less cumbersome programs was the rationale 
behind breaking up the program into the 12 separate pro- 
grams. Any one of the 12 programs can virtually "stand 
alone" and, therefore, each can be considered as an indepen- 
dent program. However, these independent programs when dis- 
cussed in this thesis will be referred to as "subprograms"; 
when the subprograms are considered all together, they make 
up the graphic tutorial and decoding "program". 

A. OVERVIEW 

This program provides a structure designed to assist an 
individual in learning to recognize the Navy signal flags 
and pennants and, secondly, to assist in decoding visual 
flaghoist signals in accordance with the ALLIED MARITIME 
TACTICAL SIGNAL EOOK. 
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The graphics contained in the program are used to por- 
tray and display: the twenty-six International alphabet 
flags, the ten numeral pennants, and a code/answer pennant; 
a set of the numeral flags; seventeen special flags and pen- 
nants; four substitute pennants; and a tackline or "tack". 
In the tutorial portion, these flags and pennants are shewn 
individually; in the display/decode portion, they are 
displayed in any number up to 32 on "halyards" in order to 
simulate signal flags and pennants as they would be used to 
send a message from a ship. There are also graphics presen- 
tations which depict the program framework in which the user 
will be working. In each case the user's present location in 
the program is identified, thereby giving a visual perspec- 
tive of wnere the user is in relationship to the rest of the 
program . 

E. STRUCTURE 

The structure of the program consist of two main POR- 
TIONS; the tutorial PORTION, and the display/decode PORTION. 
The tutorial PORTION has been divided into three SECTIONS, 
and each SECTION has three SEGMENTS. Each SEGMENT (within a 
tutorial SECTION) is further subdivided into either three or 
four graphic tutorial SESSIONS where the flags and pennants 
are actually presented. The display/deccde PORTION has one 
SECTION. Figure 1, on the next page, depicts this structure. 
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Diagram Depicting Program Sequence (Flow) and 
User Options Available (Continued on neit page) 



/\ /\ /\ /\ 



I 

p. I 



X 

dJ 



1 




1 


1 0 1 




















- — * 1 


- — > 


1 


1 r-H | 




















(Si 1 


i-i 


l 


H 1 ^H 1 




















1-1 1 


i— 1 


1 


r-H 1 03 1 




















^ 1 




1 

1 


<o 1 o 1 

1 1 

1 

1 


















Eh 


— 1 






1 


















Z 


co | 






1 


















w 


O 1 






1 








1 




1 






z 


<M 1 






1 








1 




1 






z 


P5 1 1 






1 1 1 




1 




1 


PM 


1 






o 


^ 1 ^ 1 






1 ^ I * — " | 




1 




1 


Pi 


1 






o 


1 <-» 1 


r-H 




1 S I H 1 


f-H 


1 




1 


O 


1 








(SJ 1 H 1 


i-H 




| iH | i-H | 


.-H 


1 


>- 


1 


O 


1 








rH 1 — ' I 


03 




1 ' j — ' | 


<0 


1 


< 


1 


w 


1 








— 1 1 




i i i 




1 


p 


1 


p 


l 














| 






cu 


1 




1 








1 






1 1 






CO * 














1 






1 1 






HH 


1 












1 






1 1 






PI 


l 












O 1 






1 1 








1 












z 1 


Eh 




1 Eh l 


&H 






1 












HH | 


Z 




3i 1 Z 1 


z 






1 












2 1 


w 




W | pci | 


w 






— 












M | 


51 




•-•I z: to i 


z 




to 


1 












1 


O 




> 1 c!J hh 1 


o 




Pi 


1 












« 1 


w 




W 1 W D 1 


w 




QJ 


1 












Eh | 
1 


to 




rt i co o i 
i i 


CO 




T3 r— V 

C2 cO 

. ^ n i 


1 

1 

1 




1 

1 

1 














T 






•H \U 
£ -H 


1 

1 


vj 

Pi 














i 






QJ P 


1 


z 


1 


1 


1 










i 






Z Pi ^H 


1 




1 


1 


1 










i 






O r-H 


1 


Z 


1 


1 


1 










i 






HH •* «#H 


1 


z 


1 


>H 1 


1 






CO 




i 






£h Z P 


1 


o 


i 


-< 1 


1 






o 


CO 


i 






O O 03 


1 


o 


1 


1 


1 


1 






Eh 


i 






PM #-H Ps 


1 




1 


Pi 1 


1 Eh 


1 




PI 


Z 


i 






CO EH ro ■ 








* CO 1 


1 I-* 


1 




c* 


«*s 


i 






O O 


1 






HH 


1 CO 


1 






z 


i 






Eh J3 


1 






P 


1 o 


1 




t-4 


z 


Z 1 <z 






CO P p 


1 








l PQ 


1 






w 


O 1 l-H o 






•-HOC- 












1 




i-H 


(X, 


w | «H 






O 04 QJ 


1 








« 


1 




o 




&h 1 O Eh 






KH 


1 










1 


- — * 


« 


p 


O 1 EH 






CiJ Z Pi 


1 










1 


P 


pp 


z 


W 1 po 




















a 


CO 


< 


CO 1 6hX 






PI—' o 


1 












o # 

cj 






1 




# 




1 

1 


















1 








1 












<M 



























X 

QJ 



&H 

Z 

w 



o 

o 



:z> 

O 



Eh 

W 



/\ /\ 



\/ V 



23 



Fig 1 (coot). Diagram Depicting Program Sequence (Flow) and 

User Options Available (Continued from previous page) 



The "Main Selection Level Menu ' is the center branching 
point within the program. It presents the user with six 
choices to choose from. These are: 

INTERNATIONAL ALPHAEET FLAGS (TUTORIAL) 

NUMERAL FLAGS ANL PENNANTS (TUTORIAL) 

SPECIAL FLAGS AND PENNANTS (TUTORIAL) 

FLAGHOIST DISPLAY /DECODE 

DETAILED PROGRAM DESCRIPTION/DIAGRAM 

QUIT 

A brief description of each selection follows. 

(1) International Alphabet Flags (Tutorial) — This SEC- 
TION contains a complete self-contained tutorial, 
which will provide the user a framework to become more 
proficient in the ability to recognize the 26 Interna- 
tional Alphabet flags. 

(2) Numeral Flags and Pennants (Tutorial) — This SECTION 
contains a complete self-contained tutorial, which 
will provide the user a framework to become more pro- 
ficient in the ability to recognize the 10 Interna- 
tional Numeral pennants and the 10 Navy Numeral flags. 

(3) Special Flags and Pennants (Tutorial) — This SECTION 
contains a complete self-contained tutorial, which 
will provide the user a framework to become more pro- 
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ficient in the ability to recognize 21 special pen- 
nants or flags. The flags and pennants contained are: 
preparative, interrogative and negative (governing 
pennants); emergency, formation, station, turn, cor- 
pen, speed and screen (maneuvering pennants); first, 
second, third and fourth substitutes (repeater pen- 
nants); starboard (direction pennant); port (direction 
flag); division and squadron (unit indicator flags); 
and designation pennant and code/answer pennant. 

(4) Flaghoist Display/Decode — This SECTION, which is the 
display/decode PORTION of the program, is for the most 
part "transparent" to the user. It is, however, a sig- 
nificant part of the program. It allows the user to 
display the flags and pennants that compose a signal 
which is to be sent or received. It also has the ca- 
pability to decode the signal if the display conforms 
to proper flaghoist signaling procedures as delineated 
in the ALLIED MARITIME TACTICAL SIGNAL ROOK. The user 
is advised if, for any reason, the present 
flag/pennant arrangement cannot be decoded. 

(5) Detailed Program Description/Diagram — this selection 
provides the user with a detailed program description 
which appears on the terminal, while simultaneously 
presenting a graphic structure diagram on the color 
screen. This description/diagram is the same option 
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the user is given when first entering the program. It 
is intended to give the user a perspective on the pro- 
gram, what options are available, and the user's 
current location within the program. This selection 
automatically returns the user to the Main Selection 
Level Menu at the completion of the presentation. 

(6) Quit — this selection allows the user to quit (exit) 
the program. In fact this is an option that the user 
may opt for at any time when an input is required to 
’advance" the program. However, before being permit- 
ted to actually leave the program, the user is re- 
quested to type in any pertinent comments about any 
aspect of the program. The quit process is reversible; 
the user will be returned to the same place in the 
program if if he decides not to terminate. 

Within each of the above first three selections - the 
tutorial PORTION of the program - the user is given the 
choice of selecting one of three SEGMENTS, besides three 
other options. 

TRAINING SEGMENT 
REVIEW SEGMENT 
QUIZ SEGMENT 

BRIEF DESCRIPTION OF SEGMENTS 
RETURN TO MAIN SELECTION LEVEL MENU 
QUIT 



26 



A brief description of each SEGMENT follows. Where the 



word "flag" appears it is to mean to be either a flag or a 
pennant . 

(1) Training Segment — will provide the user with the op- 
portunity to learn and study one single flag at a time 
from the flags in the SECTION selected. By presenting 
the user one randomly selected flag at a time along 
with its proper WRITTEN name (except in the case of 
the International Alphabet Flags where the SPOKEN name 
is given), the user can go through the mental process 
of associating a flag with a name. The size or the 
group of flags from which a particular flag is select- 
ed is an option chosen by the user. A flag will 
remain on the color screen as long as the user desires 
to have it displayed. The same flag will not appear 
until six other flags have been presented. Another 
flag automatically appears each time the carriage re- 
turn key is depressed. 

(2) Review Segment — will allow the user to choose 
from two options. The first option presents one ran- 
domly selected flag at a time from the SECTION in a 
similar manner as in the Training Segment. Howev- 
er, unlike in the Training Segment, the name of the 
flag does not appear simultaneously thereby giving 
the user the opportunity to identify the flag "on 
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his own". The correct name of the flag is delayed for 
four seconds. When it appears it essentially pro- 
vides instant feedback to the user either in the form 

\ 

of reinforcement if properly identified or of correc- 
tion if wrongly identified. The second option re- 
quires the user to type (enter) the name of the flag 
that is desired to be presented on the screen. 
Each time a name is typed the specific flag is 
shown. By entering "all", the user is shewn all the 
flags in the SECTION on the screen simultaneously. 
This "call up" option allows for the flag of 
the user's own choosing to be shown, thereby provid- 
ing the structure for the user to go through the 
mental process of of associating a name with a flag. 



(3) Quiz Segment — will present the user with one random- 
ly selected flag at a time from the SECTION. The flag 
will remain on the screen for five seconds and then 
disappear. The user is then required to identify the 
flag by typing in its name on the keyboard. The user 
is informed by an advisory if what is entered is 
correct or not. If correct, a new quiz flag is 
presented. If incorrect, the flag will reappear and 
the user is given another chance to identify it. The 
flag will not disappear after five seconds as before? 
it will remain on the screen until another input by 



28 



the user is made. If the user correctly identifies it, 
an advisory informs the user and a new quiz flag is 
offered. If incorrectly identified, the flag's name 
is given and the program then presents the user a new 
flag to identify. The quiz can he terminated at any 
time. When the user ends the quiz, a score in given 
based on the number of correctly identified flags made 
on the initial viewing of the flag. The names of those 

flags that were incorrectly identified after being 

\ 

given two opportunities are listed. 

C. INDIVIDUAL SUBPROGRAM DESCRIPTIONS 

By referring to Appendix B a complete description of 
each of the subprograms can be obtained. The "Program Sum- 
mary Statement" located at the beginning of each subprogram 
has been extracted directly from each of the source subpro- 
grams and contains a "description" and a "content" section. 
The description contains a detailed sequential run-through 
of what each subprogram outwardly presents to the user. The 
content contains a brief outline of the structure which is, 
for the most part, transparent to the user. The content 
section also delineates the subprogram's relationship (s ) 
with other subprograms. 

The complete source code for each of the subprograms was 
originally to be included as part of the thesis. However, 
because of the length of some of the subprograms, this in- 



29 



elusion was considered as impractical. Access to the code is 
a relatively easy evolution to perform for anyone vho wishes 
to obtain a ccpy of any (or all) of the source subprograms. 
Appendix A outlines the necessary procedure to acquire ac- 
cess . 

Figure 2, located on the next page, depicts the rela- 
tionships the various subprograms have among one another. 
The titles on the diagram are the compiled programs' names 
as they are actually called. 
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IV. RECOMMENDATIONS FOR FUTURE DEVELOPMENT 



First, although the current program has met the stated 
objective and it has incorporated within it all the design 
features that are considered as necessary tc have a success- 
ful user-oriented interactive program, there are several 
“additions" which could be included at seme later date to 
make it even more appealing. Second, the current decoding 
portion of the program shows only a "capability"; it con- 
tains the code necessary to decode only a few of the 
chapters in ATP 1(B), Vol II. The present capability is 
listed in Appendix C. Last, the entire objective must be 
examined in the context of "cost versus value", and a deter- 
mination must be made whether the pursuit of a fully opera- 
tional product is a worthy endeavor. 

The envisioned long range application for the program is 
to install such a program onboard a naval vessel for at-sea 
use. Hardware necessary to support the program would, by 
necessity, most likely have to be reduced to a "desk top" 
configuration with the possibility of running several remote 
graphic CRT's, if graphics were desired; and a "hand calcu- 
lator" configuration if graphics were not particularly 
necessary. The program would be used when a vessel was re- 
ceiving a flaghoist (or flashing light or semaphore) mes- 
sage. The duty signalman would enter the flags on a keyboard 
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as they are visually read. After entering the flags which 
make up the signal, the user merely has to type "decode", 
verify or confirm that the flags are the ones sent, before 
reading the meaning of the signal on a screen (CRT) cr in a 
window. The Commanding Officer and/or Officer of the Deck 
could also be provided with a remote CRT so that the message 
could be instantaneously delivered to the ultimate intended 
receiver. The tutorial portion of the program would be util- 
ized onboard ship to keep proficiency high in recognition of 
the flags, and on shore at these installations where signal 
flag training is a requirement (for example, Signalman "a" 
School, Officer Candidate School and Surface Warfare Officer 
School ) . 

One of the "additions’ that would make the program more 
appealing would be to reduce and/or convert the present pre- 
gram» which is dependent on the PDP 11/73 and Genisco, to 
one which fits into a microcomputer with a graphics capabil- 
ity or into (smaller still) a pocket translator/calculator 
size device without a graphics capability. Putting the pro- 
gram (excluding the graphics capability for the present 
time) on a "chip" so that it could be then easily updated 
and even encrypted when necessary in order that it then 
could be put into some small hand held device is the ulti- 
mate goal. To speed the process between reading the flags 
and being presented the meaning, voice input of the flags 
possibly could be added. In any case, memory space and size 
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studies would have to be conducted on the feasibility of any 
of the above configurations before the present program could 
be made more readily available to its potential users in the 
Fleet . 

Before the program can be considered completely ready 
for evaluation and use, the decoding portion of the program 
must be finished. Presently, the program can only claim to 
demonstrate the capability. The author, however, has care- 
fully selected those chapters thus far incorporated in the 
program as representative of the remaining material in ATP 
1(B), Vol II. For this reason there does not appear to be 
anything more intricate to program than what has already 
been done. Memory space may become a limitation, but this 
should not be difficult to overcome on the PDP 11/70. 
Research into possibly a better method and/or language to 
code this portion of the program could lead to a program 
more efficient overall. 

A premise of this thesis was that the stated objective 
was worthy enough to develop an alternate approach in order 
to satisfy it. Now that an alternative has been developed, 
the user community should be approached to see if such a 
product has real "user appeal". If it is well received, 
still another major hurdle must be overcome. That hurdle is 
cost. The present system for learning the flags and pen- 
nants used in flaghoist, and decoding (and encoding) 
flaghoist displayed signals consists of a pack of 68 flash 
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cards and one formidable publication. What is proposed to 
replace these items would require a rather sophisticated, 
though easy to operate, piece of computer equipment. 
Although the cost of such equipment is decreasing continu- 
ously, it may still be too high to make it practical. A cost 
versus value study would have to be conducted before further 
substantial time investments are devoted to actually writing 
the decoding code. It is the opinion of the author after 
studying the matter, that the tutorial and decoding product 
is beneficial from the user's standpoint, but that its mone- 
tary cost may be prohibitive at this time. 

The final improvement that is recommended would be to 
create, design and develop a natural language ENCODE coun- 
terpart to the decode portion of the program. This would be 
a formidable undertaking but great strides have been made 
recently in natural language query routines and systems. 
Many of the techniques derived could be applicable in 
developing an efficient encoding scheme. 
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APPENDIX A 



PROGRAM OPERATING INSTRUCTIONS 

An individual desiring eitner to view the source code or 
run the "Graphic Tutorial and Decoding Program for Navy Sig- 
nal Flags and Pennants" must first place the program's 
source and object files into his/her directory. This is ac- 
complished by making the necessary arrangements to or fol- 
lowing the procedures for mounting a magnetic tape labeled 
"FLAGS", which is stored in the 03 Lab in the custody of the 
manager of the C3 Lab. 

To run (execute) the tutorial and decoding PROGRAM, once 
all the subprograms are loaded/transf erred into the user's 
directory, the subprogram "flag" should be initially called. 
"Flag" is the only subprogram which offers the user a choice 
of Genisco screens which can be activated, and which allows 
the user to choose another section of the program in which 
to go. If called first, all other subprograms will automati- 
cally default to Genisco screen " 0 " (left bey screen in the 
C3 Lab). Moreover, when in certain subprograms the command 
"main" is entered — which is required prior to being able to 
select another section — the subprogram will exit automati- 
cally and return the user back to the UNIX executive shell 
level unceremoniously and without any advance warning. 
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Cnee "flag" is called, the user should be able to util- 
ize the program as long as desired. The program was inten- 
tionally designed and structured to "stand alone" (i.e., to 
be self explanatory) and does not require any user's manual. 
If the user does encounter a situation which is seemingly 
ambiguous or confusing, entering "help" or "?" will provide 
an advisory which will delineate the options available to 
rectify the situation. The user must, however, have some 
knowledge of flaghoist procedures and terminology to derive 
maximum benefit from the decoding section of the pregram. No 
other operator instructions should have to be given to the 
prospective user before beginning the program. 

The program is self-helping and uses simple interface 
commands. The user has the opportunity to view detailed in- 
structions and a graphic diagram describing the entire pro- 
gram just after entering the program. If the user opts not 
to see these, he can bypass them and go directly into the 
Main Selection Level Menu (MSIM); however these instructions 
are always available to the user as one of the options in 
the MSLM . 

The program employs the techniques of interaction by an- 
ticipation since the commands required to progress through 
the program are the characters corresponding to the correct 
name of the flag or pennant. The remaining commands are 
consistent in their meaning throughout the program, and 
should not be ambiguous to even the novice user. 



3 ? 



The program contains defaults in case the user mistypes 
an input. If the input is not immediately acted upon, the 
program will echo the user's entry. Within the decoding 
portion of the program there is a verbosity option which al- 
lows the user to tailor the amount of information received 
after an entry is made. There are three different verbosity 
levels to choose from. 

The program allows the user to quit and exit the program 
from any point but requires the user to verify his intention 
to quit before the program halts and returns to the UNIX 
shell command level. Prior to quitting, the user is re- 
quested to enter any comment(s) that may be considered ap- 
propriate . 

In order to monitor the utility of the program, code has 
been incorporated within two of the subprograms which will 
record time of user entry and exit, along with any comments 
that the user makes when quitting the program. These sub- 
programs will have to be modified if someone (other than the 
author) would like this information. Subprograms "flag.c" 
and "quit.c" have been documented sufficiently to permit 
someone else to do this. 

All the subprograms are written in the "c” language. A 
basic understanding of "c" is necessary if the reader in- 
tents to modify the subprograms themselves. A conscientious 
effort was made to provide detailed documentation along with 
each subprogram. 
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All the subprograms were compiled using the compiler 



command kcc". For example, to compile the subprogram 
"flag.c" (all programs must have a filename of the form 
"(filename) .c" ) the shell command "kcc (filename)" is en- 
tered followed by a carriage return, "kcc" is a filename 
itself containing the following compiler command calls: 
cc $l.c /usr/graphics/genlib .a 
/usr/graphics/genlib.a /usr/graphics/genlib. a 



This compiler allows more streamlined graphics commands to 
be used in the Genisco source code. 



39 



APPENDIX B 



SUBPROGRAM SUMMARY STATEMENTS 



PROGRAM: flag.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: TEE INITIALLY CALLED PROGRAM FOR THE NAVY 
SIGNAL FLAGS AND PENNANTS PROGRAM. 

USER IS GREETED TO PROGRAM ON THE CRT, AND REQUESTED TO 
AUTOMATICALLY WITH SOME BASIC PROGRAM REMINDERS. FOLLOWING 
THIS THE USER IS GIVEN A CHOICE OF WHAT GENISCO SCREEN IS 
TO BE UTILIZED. AFTER THIS HAS BEEN DETERMINED AND THE 
SELECTION ECHOED, TEE PROGRAM THEN PRESENTS TO USER TEE 
FORMAL INTRODUCTION TO THE PROGRAM ON THE GENISCO SCREEN, 
FOLLOWED BY AN OVERVIEW OF TEE OBJECTIVES 0? THE PROGRAM ON 
THE CRT. TEE USER IS TEEN ASKED IF A MORE DETAILED 
DESCRIPTION OF THE PROGRAM - WITH A GRAPHIC DIAGRAM - IS 
DESIRED. IF THE USER SELECTS THIS OPTION A SIX PART 
SIMULTANEOUS CRT/SCREEN DESCRIPTION/DIAGRAM PRESENTATION IS 
PROVIDED. THE USER CARRIAGE RETURN KEY. AT TEE END OF THIS 
OPTION THE USER IS AUTOMATICALLY PROVIDED WITH THE MAIN 
SELECTION LEVEL MENU (MSLM) WEERE EE MAY MAKE ONE OF SIX 
CHOICES. IF THE USER DID NOT SELECT THE DESCRIPTION/DIAGRAM 
OPTION, THE MSLM IS PRESENTED IMMEDIATELY AFTER THE POINT 
WHERE WEEN TEE USER INDICATED TEAT TEE OPTION WAS NOT 
DESIRED. 

CONTENTS: TRANSPARENT TO THE USER WHEN SIGNING-IN IS THAT 
THE NAME BEING ENTERED IS AUTOMATICALLY BEING PLACED IN A 
FILE CALLED 'INPUT' IN A DIRECTORY PRESENTLY WITHIN 'EIEN'. 
[NOTE :THE 'PROGRAM MONITOR' WILL HAVE TO INSURE 
THAT AN 'INPUT' FILE IS MAINTAINED IN HIS/HER DIRECTORY AND 
THAT flag.c IS PROPERLY MODIFIED TO HANDLE THIS. THIS ALSO 
MUST BE DONE IN THE auit.c SUBPROGRAM.] WHEN THE CARRIAGE 
RETURN IS TYPED TEE CURRENT TIME IS ALSO PLACED IN THE 
FILE 'INPUT' UNDER TEE HEADING OF 'TIME LOGGED IN:' THIS 
FILE 'INPUT' HAS BEEN CREATED IN ORDER TO MONITOR USE OF 
THE PROGRAM, AND ALSO — MORE IMPORTANTLY — AS AN RECEPTACLE 
FOR USER INPUT COMMENTS WHICH ARE SOLICITED WHEN THE USER 
INDICATES TEAT HE DESIRES TO 'QUIT' (EXIT) THE PROGRAM. 
iSEE quit.c PROGRAM FOR MORE DESCRIPTION OF THIS OPTION.) 



A CONCERTED EFFORT EAS EEEN MADE IN ORDER TO MAKE THE 
PROGRAM WHERE 'AUTOMATIC ADVANCEMENT' OF THE PROGRAM IS NOT 
PRESENT. IN OTHER WORDS, EVERYWHERE TEAT TEE USER MUST 
TYPE IN SOME ENTRY - EE IT EVEN A CARRIAGE RETURN - AND AN 
ERRONEOUS ENTRY IS MADE INSTEAD OF THE ONE (OR CNE FROM THE 
GIVEN SELECTION) PROMPTED FOR, AN ADVISORY WILL BE GIVEN 
INFORMING THE USER THAT WHAT WAS JUST TYPED/ENTERED WAS NOT 
ACCEPTED AND THAT ANOTHER INPUT IS NECESSARY TO CONTINUE 
TEE PROGRAM. THERE ARE ALSO ADVISORYS PROVIDED IF TEE USER 
GETS 'CONFUSED' OR 'LOST' AND TYPES '?' OR 

THE PROGRAM AUTOMATICALLY FORKS TO (AND RETURNS FROM) 
intro. c AFTER SCREEN SELECTION EAS BEEN DETERMINED. TEE 
PROGRAM FORKS TO alphab.c IF INTERNATIONAL ALPHABET FLAGS 
SELECTED; TO numbs. c IF NUMERAL FLAGS AND PENNANTS 
SELECTED; TO special . c IF SPECIAL FLAGS AND PENNANTS 
SELECTED; TO submain.c IF FLAGHOIST DISPLAY SELECTED; TO 
quit .c IF QUIT SELECTED; OR TO THE SUBROUTINE DescrO IF 
THE USSR WANTS TO REVIEW TEE DESCRIPTION/DIAGRAM 
PRESENTATION OPTION AFTER VIEWING TEE MAIN SELECTION LEVEL 
MENU. 



PROGRAM: intro.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: PROVIDES THE OPENING GRAPHICS FOR THE NAVY 

SIGNAL FLAGS AND PENNANTS PROGRAM. DISPLAYS FLAGS WHICH 
SPELL CUT IN CLEAR TEXT 'NAVY FLAGS AND PENNANTS' FOLLOWED 
BY WRITTEN TITLE OF PROGRAM AND AUTHOR'S NAME. 

CONTENTS: CALLED AUTOMATICALLY BY flag.c, AND RETURNED 
AUTOMATICALLY TO flag.c. CONTAINS NO OPTIONS. ENTIRE 
SUBPROGRAM IS NON-INTERACTIVE. (SUGGEST THIS SUBPROGRAM EE 
EYPASSED WHEN ACCESSING flag.c A NUMBER OF TIMES WHILE 
PERFORMING ANY SORT OF MAINTENANCE. SEE flag.c AT FORK TO 
TEIS SUBPROGRAM FOR SUBSTITUTE CODE FOR BYPASSING THIS 
SUBPROGRAM. ) 
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PROGRAM : alphab.c ***(ALSO [numbs. c] AND {special .c } )*** 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: BY SELECTING THIS OPTION THE USER DESIRES TO 

LEARN/STUDY THE INTERNATIONAL ALPHABET ELAGS (26) [TEE 
NUMERAL FLAGS (10) AND PENNANTS (10)] (THE SPECIAL FLAGS 
AND PENNANTS (21)} . 

THE USER IS PROVIDED WITH A SECTION MENU WITE CHOICE OF 
FOUR MAIN OPTIONS (BESIDES CAPABILITY TO QUIT AND TO RETURN 
TO THE MAIN SELECTION LEVEL MENU ( MS LM ) ) , DEPENDING ON WHAT 
SEGMENT (TYPE OF FLAG PRESENTATION) IS DESIRED. TEE 
TRAINING SEGMENT PROVIDES ONE SINGLE RANDOM FLAG WITE ITS 
CORRECT NAME SIMULTANEOUSLY; REVIEW SEGMENT PROVIDES TWO 
MAIN OPTIONS WITHIN ITSELF: (l) A RANDOM FLAG DISPLAYED 
WITH FOUR SECOND DELAY OF THE FLAG'S NAME, (2) FLAG 
DISPLAYED WITH NO NAME (FLAG NAME TYPED ON KEY BOARD TO 
CALL FLAG TO SCREEN.) OR BY ENTERING SCREEN TOGETHER; AND 
QUIZ SEGMENT WHICH PRESENTS A RANDOM FLAG AND USER MUST 
PROVIDE NAME. A SCORE IS MAINTAINED IN THIS SEGMENT. THE 
FORTE OPTION PROVIDES USER WITE A BRIEF DESCRIPTION OF EACH 
OF TEE SEGMENTS FOR USER'S PERUSAL. WITHIN THE TRAINING AND 
QUIZ SEGMENTS THERE ARE THREE TUTORIAL SESSIONS; WITHIN THE 
REVIEW SEGMENT THERE ARE FOUR SESSIONS. THE FIRST SESSION 
WITHIN ANY OF THE SEGMENTS DISPLAYS A RANDOM FLAG FROM ONE 
HALF OF ALL TEE FLAGS IN THE SECTION (A-M [0-9] {10 SPECIAL 
PENNANTS}), TEE SECOND SESSION WITHIN ANY OF TEE SEGMENTS 
DISPLAYS A RANDOM FLAG FROM THE REMAINING FLAGS IN THE 
SECTION (N-Z [p0-p9] { 11 SPECIAL PENNANTS}) AND THE THIRD 
SESSION TAKES A RANDOM FLAG FROM THE ENTIRE GROUF OF FLAGS 
AVAILABLE (A-Z [0-9 S. p0-p9] (21 SPECIAL PENNANTS}). THE 
FOURTH SESSION WITHIN THE REVIEW SEGMENT ALLOWS THE USER TO 
DISPLAY ANY FLAG OF TEE USER'S OWN CEOOSING, OR ALL TEE 
FLAGS TOGETHER. 

CONTENTS: THERE ARE NO LIMITATIONS TO A TUTORIAL SESSION; 

WHEN THE USER DESIRES TO TERMINATE A SESSION ALL TEAT IS 
REQUIRED IS 'end' TO BE ENTERED. THE USER WILL BE RETURNED 
THE SECTION MENU AT THE END OF EVERY SESSION. THE USER MAY 
RETURN TO TEE MSLM OR QUIT FROM EITHER A SESSION OR AT TEE 
SECTION MENU LEVEL. HOWEVER, ONCE A SEGMENT HAS EEEN 
SELECTED, THE USER IS NOT PERMITTED TO RETURN TO THE MSLM 
OR QUIT UNTIL THE USER IS WITHIN A TUTORIAL SESSION. 

CALLED FROM flag.c MAIN SELECTION LEVEL MENU WITE INPUT 'a' 
['n'] {'s'}. FORKS TO allalphab.c [allnumbs.c] 

{allspecial .c} IF USER SELECTS COMMAND 'all' IN THE CALL UP 
OPTION OF REVIEW SEGMENT. FORKS BACK TO flag.c WITH 'main'; 
TO quit.c WHEN 'quit' ENTERED. 
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PROGRAM: allalphab.c 

** (ALSO [allnumbs.c] AND {all special .c} )** 
PROGRAM SUMMARY STATEMENT 

DESCRIPTION: DISPLAYS TO THE USER ALL THE 26 [20] {21} 

FLAGS/PENNANTS IN THE SECTION ON THE SCREEN AT ONE TIME. 

CONTENTS: CALLED FRCM alphab.c [numbs. c] {special. c} WITH 

INPUT SUBPROGRAM WHEN ALL FLAGS /PENNANTS ARE DISPLAYED. 
CONTAINS NO OPTIONS. ENTIRE SUBPROGRAM IS NON-INTERACTIVE. 



PROGRAM: submain.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: GREETS USER TO DISPLAY/DECODING PORTION OF 

PROGRAM. PROVIDES USER INPUT REMINDERS AND THEN PRESENTS 
THE CURRENT DECODING CAPABILITIES BUILT INTO TEE PROGRAM. 
THE USER IS TEEN GIVEN TEE OPTION TO CHOOSE FROM THREE 
LEVELS OF VERBOSITY. NEXT THE USER IS GIVEN THREE OPTIONS 
FROM WHICH TO CHOOSE WHAT FLAGEOIST DISPLAY CONFIGURATION 
IS DESIRED. THE FINAL OPTION PROVIDES THE USER, IF CHOSEN, 
WITH ALL THE VARIOUS KEYSTROKE COMMANDS (OTHER THAN 
FLAG/PENNANT NAMES) WEICE WILL BE ACCEPTED. 

CONTENTS: (THIS SUBPROGRAM PRIMARILY WRITTEN BECAUSE OF 

MEMORY SPACE LIMITATIONS IN f laghoist.c . ) SUBPROGRAM 
PROVIDES STRUCTURE FOR INTRODUCTION TO DISPLAY/DECODING 
PORTION. BOTH VERBOSITY AND DISPLAY CHOICES ARE ECHOED. 
DEPENDING ON WHAT VERBOSITY SETTING CHOSEN, SOME ADVISORY 
INFORMATION EITHER PROVIDED OR OMITTED. 

CALLED FROM flag.c MAIN SELECTION LEVEL MENU WITH IN- 
PUT 'fh ' (FLAGHOIST) . FORKS TO commands. c IF USER SELECTS 
COMMAND OPTION; FORKS AUTOMATICALLY TO flaghoist.c AT END. 
FORK OPTION TO quit.c AND flag.c (AT MS LM ) AVAILABLE AT 
CERTAIN POINTS. 
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FROGRAM: flaghoist.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: PROVIDES USER WITH CURRENT VERBOSITY AND 
DISPLAY SETTINGS. INFORMS USER TEAT FLAGS MAY BEGUN TO BE 
DISPLAYED. ALLOWS USER TO TYPE IN ANY FLAG OR PENNANT BY 
NAME AND DISPLAYS FLAG OR PENNANT ON A SIMULATED HALYARD OF 
THE USER'S CEOOSING IN FLAGHOIST ORDER. USER MAY 
CHANGE/MODIFY FLAGS DISPLAYED BY USING APPROPRIATE COMMANDS 
PROVIDED FROM THE 'COMMANDS' LISTING. WHEN THE USER HAS THE 
SIGNAL DISPLAYED ON THE SCREEN WHICH EE WANTS TO HAVE 
DECODED, THE COMMAND 'decode' IS ENTERED. TEE PROGRAM 
RETURNS THE NAME OF THE FLAG ( S ) AND ITS (THEIR) FLAG 
POSITION (S ) FOR THE USER TO CONFIRM, BEFORE ATTEMPTING TO 
DECODE THE SIGNAL. MEANING OF SIGNAL IS NATO CONFIDENTIAL 
WHEN ARRANGEMENT OF FLAGS AND MEANING ARE ASSOCIATED. 

CONTENTS: CALLED FROM submain.c AUTOMATICALLY WEEN 

submain.c ENDS. FORKS TO commands. c WHEN EITHER 'commands' 
OR 'help' ENTERED; AUTOMATICALLY RETURNED AFTER COMMANDS 
ARE PRESENTED ON CRT. ACCEPTS ANY CORRECT FLAG NAME OR 
COMMAND AND EITHER DISPLAYS FLAG OR EXECUTES COMMAND. FORKS 
TO atp.c SUBPROGRAM IF USER SO INDICATES A DESIRE TO KNOW 
IF THE DISPLAYED FLAGHOIST SIGNAL IS VALID I.E., HAS A 
MEANING. ALLOWS USER TO LCOP AS MANY TIMES AS DESIRES; WHEN 
USER CHANGES DISPLAY OPTION ALL FLAGS ARE REMOVED J DISPLAY 
OPTION TWO ( 'disp2 ' ) NOT CURRENTLY AVAILABLE DUE TO MEMORY 
SPACE/COMPILE CONSTRAINTS. FORK OPTION TO quit.c AND 
flag .c AT THE MSLM AVAILABLE AT ANY TIME. 

NOTE TO ADVANCED USERS OF THE PROGRAM: BY TYPING 'flag- 

hoist' FROM THE UNIX SHELL LEVEL, THIS SUBPROGRAM CAN 
BE ACCESSED DIRECTLY WITHOUT HAVING TO GO THROUGH TEE MSLM 
(flag.c) OR THE LI SPLAY/DECODING PORTION INTRODUCTION 
(submain.c). HOWEVER, IF THE VERBOSITY AND DISPLAY 
SETTINGS ARE NOT IMMEDIATELY CHANGED TO VALUES THAT ARE 
RECOGNIZED BY THE PROGRAM, THE SUBPROGRAM WILL NOT FUNCTION 
IN A STAND ALONE CAPACITY. REMEMBER, THIS SUBPROGRAM WILL 
ONLY OPERATE IN THIS MODE AT TEE LEFT BAY SCREEN IN THE C3 
LAB BECAUSE OF THE DEFAULT TO GENISCO -0 WHICH OCCURS WHEN 
NOT INITIALLY GOING THROUGH flag.c. 
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PROGRAM: corrmands.c 



PROGRAM SUMMARY STATEMENT 

DESCRIPTION : LISTS ALL THE COMMANDS AVAILABLE FOR MODIFYING 
DISPLAYED FLAGS, OR FOR CHANGING VERBOSITY LEVEL AND 
DISPLAY CONFIGURATION. 

CONTENTS: CALLED BY suhmain.c OR flaghoist.c. RETURNS TO 
CALLING SUBPROGRAM WEEN CARRIAGE RETURN (OR ANY OTHER 
INPUT) ENTERED? NO OTHER OPTIONS ARE AVAILABLE. 



PROGRAM: atp.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: PROVIDES TEE USER WITH THE MEANING OF TEE 
DISPLAYED FLAGS/PENNANTS ON CRT. 

CONTENTS: ALMOST ENTIRELY TRANSPARENT TO THE USER, THIS 
SUBPROGRAM CONSISTS OF ONE VERY LARGE 'IF' LOOP WHICH 
ATTEMPTS TO SEARCH FOR A MATCE BETWEEN WHAT IS IN THE FIRST 
ONE TO FOUR FLAG POSITIONS WITH A 'DATA BASE' CONSISTING OF 
BASIC GROUPS EXTRACTED FROM ATP 1(B), VOL II. WEEN A 
MATCH OCCURS THE MEANING IS PRESENTED AND THE SEARCH 
CONTINUES USING THE NEXT GROUP. A GROUP IS DEFINED AS AN 
ARRAY OF THOSE UNIQUE FLAG NUMBERS UP TO BUT NOT INCLUDING 
A TACK (66) OR A SPACE (0). TACKS AND SPACES ARE 
DISREGARDED BUT ARE USED AS END OF ARRAY AUTOMATICALLY TO 
flaghoist.c AFTER ALL FLAG NUMBERS HAVE BEEN SEARCHED FOR 
AND MEANING HAS/HAS NOT BEEN FOUND AND PRESENTED ON THE 
SCREEN. IF NO MATCE IS FOUND, AN ADVISORY INFORMING THE 
USER OF THIS IS PRESENTED. 

THIS SUBPROGRAM IS NATO-CONFIDENTIAL AND SHOULD BE ACCORDED 
THE PROPER SECURITY FOR SUCH A CLASSIFICATION. 
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PROGRAM: *uit.c 

PROGRAM SUMMARY STATEMENT 

DESCRIPTION: REQUESTS THE USER EEFORE TERMINATING THE 
PROGRAM TO TYPE IN ANY COMMENTS THAT ARE DEEMED 
APPROPRIATE. IF THE USER WISHES NOT TO COMMENT, (S)HE THEN 
MAY EXIT DIRECTLY. IF THE USER DESIRES TO RETURN TO THE 
PROGRAM, (S )EE ENTERS 'ret' AND IS REINSTATED AT THE SAME 
LOCATION IN THE PROGRAM AS BEFORE. 

CONTENTS: PRESENTS A GRAPHICS 'TO WARN' USER THAT THE END 
OF TEE PROGRAM MAYBE NEAR. IF USER INDICATES TEAT (S)HE 
WISHES (WILLING) TO MAKE SOME COMMENTS, THE 'INPUT' FILE IS 
OPENED TO RECEIVE ENTRIES UP TO EIGHT LINES IN LENGTH; TIME 
OF EXIT ALSO ENTERED. IF THE USER INDICATED THAT NO 
COMMENTS ARE WANTED TO BE MADE 'INPUT' OPENED TO RECORD 
TIME OF EXIT AND AUTOMATIC ENTRY OF 'NO COMMENT'. (SEE ALSO 
f lag .c . ) 

CALLED BY flag.c, alphab.c, numbs. c, special. c, submain.c, 
OR flaghoist.c. RETURNS TO CALLING SUBPROGRAM WHEN 'ret' 
ENTERED. ALLOWS USER TO 'EXIT GRACEFULLY' FROM TEE PROGRAM. 
PROCESS IS REVERSIBLE. 

SINCE RETURNING TO THE UNIX SHELL COMMAND (THE REAL 
INTERPRETATION OF QUITTING) CAN ONLY BE ACCOMPLISHED BY 
EXITING OUT THROUGH THE INITIALLY ENTERED PROGRAM, A 
PROSESS WAS DEVISED TO 'BACKTRACK' THROUGH THE VARIOUS 
SUBPROGRAMS FORKED INTO. THIS WAS ACCOMPLISHED BY CARRYING 
A VALUE IN THE 'exit' ARGUMENT. A PRIOR TO ENTERING THE 
quit.c SUBPROGRAM; A '1' (ONE) VALUE WOULD RETURN ALL THE 
WAY EACK TO flag.c WHERE IT THEN WOULD RETURN TO THE UNIX 
SHELL. (SEE ADDITIONAL DOCUMENTATION WITHIN SUBPROGRAM.) 



\ 
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APPENDIX C 



CURRENT PROGRAM DECODING CAPABILITY 

The following is extracted directly from the "submain .c" 
subprogram and lists the current decoding capability of the 
program . 

PRESENTLY INCORPORATED IN THE DECODING PORTION OF THE 
PROGRAM ARE THE FOLLOWING CHAPTERS, ARTICLES, PARAGRAPHS 
FROM ATP 1(B), VOL II. (AS OF 15 MAR Si) 



111 


GOVERNING 


PENNANTS 


112 


GOVERNING 


GROUPS 


115 


PLAIN TEXT (NOTE 1 ) 


122 


UNITS OF 


REFERENCE (partial) (NOTE 1) 


123 


FRACTIONS 


(NOTE 1) 


124a ,c 


TIMES 




126b, c 


BEARING AND DIRECTION/DISTANCE (NOTE 1) 


128a ,b ,c 


METHOD OF 


ORDERING SECTORS (NOTE l) 


301 


EMERGENCY 


EXECUTE SIGNAL 


302 


EMERGENCY 


ALARM SIGNALS 


303 


EMERGENCY 


ACTION SIGNALS 


1001 


ANTIAIR WARFARE SIGNALS 



NOTE 1 '.WHERE APPLICABLE IN SIGNALS EXTRACTED FROM CHAPT 3-32. 



47 



BIBLIOGRAPHY 



Kernighan, B. V. , Programming in C - A Tutorial . Bell La- 
boratories, undated. 

Kernighan, B. W. , and Ricthie, D. M., The C Programming 
Language , Bell Telephone Laboratories, Inc. ,1978. 

Naval Ocean Systems Center Technical Document 247, A Guide 
to U.S.Navy Command, Control, and Communications , by 
D. A. Paolucci, N. Polmar and J. Patrick, 1 July 1979. 

Signalman 3 & 2 , NAVTRA 10135-D, Naval Education and 

Training Support Command, 1975. 

Smith, L. B., "The Use.of Interactive Graphics To Solve 
Numerical Problems", Communications of the ACI* . v. 13, 
October 1970 . 



48 



INITIAL DISTRIBUTION LIST 



Nc. Copies 

1. Defense Technical Information Center 2 

Cameron Station 

Alexandria, Virginia 22314 

2. Library, Code 0142 2 

Naval Postgraduate School 

Monterey, California 93940 

3. C3 Laboratory, Code 52 2 

Naval Postgraduate School 

Monterey, California 93940 

4. Captain Wayne P. Hughes Code 55H1 1 

Department of Operations Research 

Chair of Applied Systems Analysis 
Naval Postgraduate School 
Monterey, California 93940 

5. Lt Cel J. W. Johnson Code 39 1 

Naval Postgraduate School 

Monterey, California 93940 

6. Professor John M. Wozencraft Code 74 3 

Chairman, C3 Academic Group 

Naval Postgraduate School 
Monterey, California 93940 

7. Lt Col Thomas P. Stack, USAF 1 

SEAPE/SEOC 

APO New York, 09055 

8. LCDR Jay Kent Bien 18 

P.O.Box 424 

West Falmouth, Massachusetts 02574 



49 



c7 J 0 l Q2 



2 8 3 2 5 



Thesis 

B5175 Bien 
c .1 A 

and 
for 
and 



192305 

graphic tutorial 
decoding program 
Navy signal flags 
pennants . 



[ 

c 

- 



i J L b 

** i J u l u d 



2 8 3 2 5 
2 8 3 2 5: 



Thes i s 
B5175 
c .1 



192305 

Bi en 

A graphic tutorial 
and decoding program 
for Navy signal flags 
and pennants. 



thnnUM/l. 

A graphic tutorial and decoding program 




3 2768 001 03642 9 
DUDLEY KNOX LIBRARY 



